Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
Atlassian Operations Terraform プロバイダーを使用すると、ユーザー、チーム、エスカレーションなどを含む Jira Service Management のリソースを Terraform から直接管理できます。Opsgenie から Jira Service Management に移行する場合、または移行を最近完了した場合は、Opsgenie Terraform プロバイダーの設定を Atlassian Operations Terraform プロバイダーに移行できます。これにより、引き続き Terraform を活用して、Jira Service Management でデータをシームレスに操作および管理できます。
Atlassian Operations Terraform プロバイダーをセットアップするには、required_providers ブロックに、atlassian-operations プロバイダー設定を追加します。プロバイダーを使用する前に、有効な認証情報を使用してプロバイダーを設定してください。Atlassian Operations Terraform プロバイダーの設定方法についてご確認ください。
利用可能なリソースとデータソースの詳細については、左側のナビゲーション メニューを使用します。現在、プロバイダーは 6 つのリソースと 3 つのデータソースをサポートしています。
Terraform を使い始めるには、入門チュートリアルを参照してください。
Cloud id - https://my-site-name.atlassian.net/_edge/tenant_info でサイトの Cloud ID を確認します。
Domain name- サイトの URL (例: my-site-name.atlassian.net)
email_address - Atlassian アカウントに関連付けられたメール アドレスを使用します。
API Token - Atlassian アカウントに追加された API トークン。Atlassian アカウント用の API トークンを表示および管理する。
api_retry_count- 失敗したリクエストの再試行回数。
api_retry_wait- 失敗したリクエストを再試行するまでの待機秒数。
api_retry_wait_max- 再試行の最大時間 (秒)。
Jira Service Management に移行する Opsgenie ユーザーの場合、エンティティ識別子は Atlassian Operations Terraform プロバイダーでサポートされているタイプのまま変更されないため、シームレスに移行できます。ただし、既存のリソース ID を imports.tf ファイルにエクスポートするには、現在手動で実行する必要があります。
必要なリソース識別子を確認するには、状態ファイルを参照します。以下の手順に従って、リソースをマッピングしてインポートしてください。
Opsgenie のリソース タイプ | Atlassian Operations のリソース タイプ |
---|---|
opsgenie_team | atlassian-operations_team |
opsgenie_schedule | atlassian-operations_schedule |
opsgenie_schedule_rotation | atlassian-operations_schedule_rotation |
opsgenie_escalation | atlassian-operations_escalation |
opsgenie_api_integration | atlassian-operations_api_integration |
opsgenie_email_integration | atlassian-operations_email_integration |
Atlassian Operations Terraform プロバイダーでは、チーム、予定、予定のローテーション、エスカレーション、API 統合、メール統合などのリソースのインポートがサポートされています。Terraform プロバイダー CLI を使用すると、既存のリソースを Atlassian Operations Terraform プロバイダーに簡単にインポートできます。Terraform CLI におけるインポートに関する詳細をご確認ください。
Terraform のインポート機能を使用して、既存のリソースを状態ファイルに追加します。imports.tf ファイルの準備について詳しくは、Terraform CLI におけるインポートを参照してください。
以下の設定を使ってチームをインポートします
1
2
3
4
import {
to = atlassian-operations_team.<TEAM_VARIABLE_NAME_HERE>
id = "<TEAM_ID_HERE>,<ORGANIZATION_ID_HERE>"
}
1
2
3
4
import {
to = atlassian-operations_schedule.<SCHEDULE_VARIABLE_NAME_HERE>
id = "<SCHEDULE_ID_HERE>"
}
1
2
3
4
import {
to = atlassian-operations_schedule_rotation.<SCHEDULE_ROTATION_VARIABLE_NAME_HERE>
id = "<ROTATION_ID_HERE>,<SCHEDULE_ID_HERE>"
}
1
2
3
4
import {
to = atlassian-operations_escalation.<ESCALATION_VARIABLE_NAME_HERE>
id = "<ESCALATION_ID_HERE>,<TEAM_ID_HERE>"
}
1
2
3
4
import {
to = atlassian-operations_api_integration.<API_INTEGRATION_VARIABLE_NAME_HERE>
id = "<INTEGRATION_ID_HERE>"
}
1
2
3
4
import {
to = atlassian-operations_email_integration.<EMAIL_INTEGRATION_VARIABLE_NAME_HERE>
id = "<INTEGRATION_ID_HERE>"
}
imports.tf ファイルを準備したら、Terraform が提供している plan コマンドを使ってリソース構成を生成します。
例:
1
terraform plan -generate-config-out="generated_resources.tf
詳細については、「Terraform’s import - Generating configuration documentation (Terraform のインポート - 設定ドキュメントの生成)」を参照してください。
設定ファイルを生成したら、設定を確認し、必要に応じて更新します。
terraform apply コマンドを実行して、リソースを Terraform の状態ファイルにインポートします。
この内容はお役に立ちましたか?